Release 10.1A: OpenEdge Development:
Open Client Introduction and Programming

Customizing method definitions in a ProcObject (optional)

To customize the definitions for methods included in a ProcObject according to your application requirements:

From the Customize Persistent Procedure dialog box, select an included internal procedure or user-defined function from the Internal Procedures/User-Defined Functions list.
Choose the Customize button.

The Customize Internal Procedure dialog box or the Customize User Defined Function dialog box appears, depending on the selection. This dialog box provides:

A Procedure tab folder to modify the name and description of the method associated with the selected internal procedure or user-defined function.
A Parameters tab folder to modify the behavior of any method parameters.
A check box for internal procedures (Return 4GL RETURN-VALUE) that specifies whether the procedure returns a string containing the value of the 4GL RETURN-VALUE.
A check box for user-defined functions(Enable Unknown Return Value) that specifies whether to enable clients to access the function return value as an object in order to return the 4GL Unknown value (?) as a null. If not checked, and if available in the language, the client must use an intrinsic type for the return value that cannot represent the 4GL Unknown value (?).
A check box (Map Temp-Table Parameters to SQL ResultSets for Java) that specifies whether to map temp-table parameters to Java SQL ResultSet or OpenEdge ProDataGraph objects for Java Open Clients. This check box is disabled and unchecked if one of the following is true:
The Use AppObject Temp-Table Setting check box is checked.
The procedure passes at least one ProDataSet parameter (with or without temp-table parameters). Any temp-table parameters must map to OpenEdge ProDataGraph objects.
The procedure passes no ProDataSet or temp-table parameters.
A check box (Use AppObject Unknown Setting) that specifies whether to use the AppObject or SubAppObject setting to indicate if all method parameters and return values enable passing of the 4GL Unknown value (?) using objects to represent the Unknown value (?) as a null.
A check box (Use AppObject Temp-Table Setting), checked by default, that specifies whether to use the AppObject or SubAppObject setting to indicate if the procedure uses SQL ResultSet or OpenEdge ProDatGraph objects to map temp-table parameters for Java Open Clients. For more information, see the "Specifying AppObject and SubAppObject definitions" section. This check box is disabled and unchecked if one of the following is true:
The procedure passes at least one ProDataSet parameter (with or without temp-table parameters). Any temp-table parameters must map to OpenEdge ProDataGraph objects.
The procedure passes no ProDataSet or temp-table parameters.

In the Procedure tab folder, you can:

Rename the method (Method Name field).
Enter descriptive information for the method (Description edit box).

In the Parameters tab folder, you can set check boxes (Check to Enable Unknowns) to indicate whether one or more method parameters enable passing of the 4GL Unknown value (?) using objects to represent the Unknown value (?) as a null. If not checked, and if available in the language, the parameter uses an instrument type that cannot represent the 4GL Unknown value (?). If you check the Use AppObject Unknown Setting box, these parameter check boxes are disabled.